home *** CD-ROM | disk | FTP | other *** search
/ A.C.E. 3 / ACE CD 3.iso / files / docs / ppaint6d.lha / PersonalPaint6.4Ch05.doc < prev    next >
Text File  |  1996-03-16  |  26KB  |  700 lines

  1.                 "Personal Paint 6.4 -  5. The Brush Menu"
  2.                 
  3.  5. The Brush Menu
  4.   5.1 Load Brush
  5.   5.2 Save Brush
  6.   5.3 Print Brush
  7.   5.4 Process Brush
  8.   5.5 Restore Brush
  9.   5.6 Free Brush
  10.   5.7 Paint Mode
  11.        5.7.1 Matte
  12.        5.7.2 Color
  13.        5.7.3 Replace
  14.        5.7.4 HBrite
  15.   5.8 Color
  16.        5.8.1 Remap
  17.        5.8.2 Complement
  18.        5.8.3 Change Background to Foreground
  19.        5.8.4 Swap Background and Foreground
  20.        5.8.5 New Transparency
  21.        5.8.6 Flood Transparency
  22.        5.8.7 Next Transparency
  23.        5.8.8 Copy Image Palette
  24.   5.9 Clipboard
  25.        5.9.1 Read Brush
  26.        5.9.2 Write Brush
  27.        5.9.3 Empty
  28.   5.10 Resize
  29.        5.10.1 Stretch
  30.        5.10.2 Smaller
  31.        5.10.3 Bigger
  32.        5.10.4 Halve
  33.        5.10.5 Halve Horizontal
  34.        5.10.6 Halve Vertical
  35.        5.10.7 Double
  36.        5.10.8 Double Horizontal
  37.        5.10.9 Double Vertical
  38.   5.11 Rotate
  39.        5.11.1 Any Angle
  40.        5.11.2 90 Degrees
  41.        5.11.3 Horizontal Flip
  42.        5.11.4 Vertical Flip
  43.        5.11.5 Shear
  44.   5.12 Chop
  45.        5.12.1 Info
  46.        5.12.2 Edges
  47.        5.12.3 Planes
  48.        5.12.4 Hidden
  49.   5.13 Outline
  50.        5.13.1 Simple
  51.        5.13.2 Square
  52.        5.13.3 Shadowed
  53.        5.13.4 3-D
  54.        5.13.5 Trim
  55.   5.14 Handle
  56.        5.14.1 Custom
  57.        5.14.2 Upper Left
  58.        5.14.3 Upper Right
  59.        5.14.4 Center
  60.        5.14.5 Lower Left
  61.               5.14.6 Lower Right
  62.  
  63. 5.         The Brush Menu
  64.  
  65.    Sections 3.1.1 ("Default and Custom Brushes") and 3.1.6 ("Define
  66. Brush") introduce some general concepts about the brush and how it can be
  67. used. This chapter explains in detail all the functions which can be
  68. applied to the brush to load it, save it, set the drawing mode, apply
  69. color changes, transform it or change the position of the handle.
  70.  
  71.    A custom brush must be defined before most of the functions explained
  72. in this chapter can be used. Several menu items are automatically disabled
  73. (section 1.9.6 "Menus") when the current brush is not a custom brush.
  74.  
  75.  
  76. 5.1        Load Brush
  77.  
  78.    This function is similar to Load Image (section 4.1), except that it
  79. loads the selected picture into the current brush. In most file formats
  80. supported by Personal Paint, there is no distinction between image and
  81. brush files. Some programs may or may not store additional information
  82. into the picture file (e.g. brush handle position or screen mode
  83. information), but this does not make the file less portable. Any picture
  84. can be loaded either as an image or a brush.
  85.  
  86.    Loading a picture as a brush does not automatically change the screen
  87. mode (size, colors, interlace mode, etc.) Conversely, loading a picture as
  88. an image adapts the screen mode to represent the image better, but also
  89. limits the number of bitplanes to the maximum allowed by the Amiga system
  90. being used.
  91.  
  92.    The screen format and colors are not changed when a brush is loaded.
  93. This may cause the brush to appear distorted (twice as wide or as tall as
  94. usual, etc.) over the underlying image, or with "random" colors.
  95.  
  96.    If the brush has different colors from the current image, it is
  97. possible to apply the colors of the brush to the image palette (section
  98. 7.1.7), or vice versa (section 5.8.1). The former will only work if the
  99. image has at least as many colors as the brush. Otherwise, the image
  100. format can be changed manually to increase the maximum number of colors
  101. which can be displayed (section 4.5.3). Personal Paint offers a more
  102. "intelligent" way of dealing with images having different colors: the
  103. Color Merge function (section 7.6).
  104.  
  105.    The fact that a brush can have more colors than the current image may
  106. be very useful. For example, Original and Enhanced Architecture Amigas
  107. cannot display 256-colors at the same time. Even on these systems,
  108. however, a 256-color brush can be processed, saved and printed without
  109. loss of data. The Chop Hidden Brush function (section 5.12.4) is most
  110. useful for cutting undesired parts of a very large brush. On screen, only
  111. as many bitplanes as are supported by the system are displayed. This
  112. generally gives an incorrect display of the brush (something which looks
  113. like "all colors wrong"). Internally, however, Personal Paint continues to
  114. process the original brush data, in up to eight bitplanes.
  115.  
  116.    When the Copy Image Palette function (section 5.8.8) is applied to the
  117. brush, the image colors also become those of the brush. Otherwise, the
  118. brush retains its original colors in a separate color map (even if it has
  119. to be displayed using the current screen colors).
  120.  
  121.  
  122. 5.2        Save Brush
  123.  
  124.    This function saves the current brush in exactly the same way that Save
  125. Image stores an image. The brush can later be reloaded as a brush or an
  126. image.
  127.  
  128.    If the IFF-ILBM format is selected to save the image, additional
  129. information on the brush handle position and transparency is saved.
  130.  
  131.    Saving parts which are smaller than the screen as brushes, rather than
  132. with the entire page which contains them, saves disk space. The "UIColors"
  133. files (section 1.14), for example, are better saved as brushes if they are
  134. stored on a limited capacity storage device like Personal Paint's program
  135. disk.
  136.  
  137.    "UIColors" files are an example of a particular "tricky" file: they
  138. should be saved as brushes if it is necessary to save disk space, but it
  139. is easier to load them as images, in order to use the correct screen mode
  140. and colors immediately. These files should always be saved in the IFF-ILBM
  141. format, which for both images and pictures stores information regarding
  142. the appropriate Amiga screen mode. Actually, if saving storage space has
  143. the highest priority, the "UIColors" files could be saved as simple
  144. palettes (section 7.1.2) as well.
  145.  
  146.  
  147. 5.3        Print Brush
  148.  
  149.    This function prints the current brush, in a similar way as the Print
  150. Image function which is described in section 4.3.
  151.  
  152.    On Amigas employing chip sets prior to the AA release, images which
  153. have more colors (bitplanes) than are supported by the system can only be
  154. printed as brushes. Loading and printing such a picture as an image would
  155. result in a loss of quality (which may be very small, using the advanced
  156. options of Personal Paint), because the picture has to be adapted to the
  157. best available Amiga screen format.
  158.  
  159.    The ratio of the current environment is used to print the brush. This
  160. may result in the picture being distorted (just as it appears on the
  161. screen - section 5.1), if the brush is taken from an environment having a
  162. different display ratio. The appearance of an image can often be improved
  163. by selecting the appropriate screen mode (section 4.5) before printing it.
  164. For example, a GIF image measuring 320 by 200 pixels may appear "squeezed"
  165. if printed from a low resolution 320 by 200 PAL-mode environment, while it
  166. might look better if printed from an NTSC screen with the same
  167. resolution.
  168.  
  169.  
  170. 5.4        Process Brush
  171.  
  172.    This command applies Personal Paint's image processing functions to the
  173. current brush, as is described for images in section 3.1.4.
  174.  
  175.    When a Dispersed, Clustered or F-S Type filter is applied to the brush,
  176. the color palette of the current environment is copied to the brush
  177. palette, since these dithering techniques employ the current foreground
  178. and background colors to simulate different color shades.
  179.  
  180.  
  181. 5.5        Restore Brush
  182.  
  183.    This command undoes the last transformation applied to the brush
  184. (including a load operation), restoring its original appearance.
  185.  
  186.    If an operation of the same class has been consecutively applied
  187. several times (e.g. a resize, rotation, transparency change, etc.), the
  188. brush is restored to the appearance it had before the first of such
  189. transformations was applied.
  190.  
  191.  
  192. 5.6        Free Brush
  193.  
  194.    This function clears the current brush and frees all the associated
  195. memory resources. Since it cannot be reversed by Restore Brush, a warning
  196. message asks for confirmation.
  197.  
  198.  
  199. 5.7        Paint Mode
  200.  
  201.    Different paint modes can be applied when using custom brushes. Each
  202. mode yields different results when a brush is pasted onto the image with
  203. the mouse. A different symbol on the title bar is associated with each
  204. setting.
  205.  
  206.    Unless otherwise specified, the current background color is used for
  207. the entire brush when the right mouse button is used for painting.
  208.  
  209.  
  210. 5.7.1      Matte
  211.  
  212.    In this mode, brushes are painted with their own colors. Areas defined
  213. as transparent are not copied. By default, these areas are associated to
  214. background colored areas when the brush is defined. Sections 5.8.5 to
  215. 5.8.7, and 8.14 explain how to further specify the areas which should be
  216. considered transparent.
  217.  
  218.  
  219. 5.7.2      Color
  220.  
  221.    In this mode, the entire brush (except its transparent parts) is pasted
  222. in the current foreground or background color (depending on which mouse
  223. button is used.)
  224.  
  225.  
  226. 5.7.3      Replace
  227.  
  228.    Like Matte, this mode paints with the individual colors of the brush.
  229. The brush transparency information is ignored.
  230.  
  231.  
  232. 5.7.4      HBrite
  233.  
  234.    When Painting in Extra Half Brite screen mode (section 4.5), where 32
  235. colors can be freely set and the other 32 are darker shades of the first
  236. 32, it is particularly useful to alternate quickly between the two
  237. associated states of a pixel.
  238.  
  239.    This mode is similar to Color, in that all non-transparent brush pixels
  240. are treated in the same way. If the left mouse button is used for
  241. painting, all image pixels under the brush are turned to their darker
  242. HBrite color. Painting with the right button activates the lighter color
  243. of each pair instead.
  244.  
  245.  
  246. 5.8        Color
  247.  
  248.    All items in this menu are used to apply color and transparency changes
  249. to the brush.
  250.  
  251.  
  252. 5.8.1      Remap
  253.  
  254.    When a brush is loaded or imported from an environment having a
  255. different color palette, it may become necessary to render the original
  256. brush as accurately as possible without disturbing the colors of the
  257. current image. While Color Merge (section 7.6) compares, changes, combines
  258. and mixes all colors of all pictures involved, Remap only changes the
  259. current brush.
  260.  
  261.    Remap chooses the colors in the image palette which most closely
  262. resemble the original colors of the brush. Dithering and error diffusion
  263. are applied to the brush if the corresponding options have been activated
  264. (section 8.7). After a remap, the brush has the same number of bitplanes
  265. as the current screen.
  266.  
  267.  
  268. 5.8.2      Complement
  269.  
  270.    This command exchanges the colors of the brush by selecting for each
  271. color position in the palette the complement of the binary number
  272. associated to that position. This may be useful, for example, for
  273. programmers to see how an image might look with Intuition's complement
  274. highlighting (which is used for gadgets, icons, etc.)
  275.  
  276.  
  277. 5.8.3      Change Background to Foreground
  278.  
  279.    This function sets all background-colored pixels in the brush to the
  280. foreground color. It provides a very selective way of changing only
  281. certain colors in the brush.
  282.  
  283.    When working on images rather than brushes, similar area-oriented
  284. results can be obtained by masking the color which is not to be changed
  285. (section 7.2.3) and then painting a filled rectangle (section 3.1.2.6)
  286. over the desired area.
  287.  
  288.  
  289. 5.8.4      Swap Background and Foreground
  290.  
  291.    This command exchanges the brush's background colored pixels with those
  292. in the foreground color, and vice versa.
  293.  
  294.    This function can be used, for example, to recolor Workbench icon
  295. images originally designed for 1.x operating systems for use in newer
  296. versions. To do this, the foreground and background colors should be set
  297. to the second and third color in the palette, respectively.
  298.  
  299.  
  300. 5.8.5      New Transparency
  301.  
  302.    Each brush may have transparent areas which do not affect underlying
  303. parts of an image when pasting. The transparent area is defined by an
  304. additional bitplane which may either be associated to a particular color
  305. (e.g. the background color), or have a custom defined shape. This bitplane
  306. is loaded and saved with the brush in the IFF-ILBM file format.
  307.  
  308.    By default, this command redefines the transparent area, making it
  309. equal to the parts having the current background color.
  310.  
  311.    The setting of the Backfill Transparency option (section 8.14)
  312. determines whether, upon definition of a brush, its transparency is to be
  313. equal to the background color, or to the single-colored area which
  314. surrounds the brush. The New Transparency option makes it possible to
  315. apply the new transparency to an already defined brush.
  316.  
  317.  
  318. 5.8.6      Flood Transparency
  319.  
  320.    The position of the brush handle, which can be set as explained in
  321. section 5.14, is used as the starting point of a "flood fill" operation
  322. which makes the selected area (i.e. group of pixels having the same color)
  323. transparent. The brush image itself is not modified: only the bitmap which
  324. defines the transparency is modified. Conversely, if the selected area is
  325. already transparent, it is made opaque again.
  326.  
  327.  
  328. 5.8.7      Next Transparency
  329.  
  330.    As explained before, each brush has an associated bitplane which
  331. describes the areas to be considered transparent or opaque. Personal Paint
  332. allows the user to define and use up to nine different brushes at the same
  333. time. If the brushes have the same size, the transparency plane of one
  334. brush can be used for another brush.
  335.  
  336.    This command applies the transparency plane of the next brush to the
  337. current one. In this process, empty brushes are skipped. If necessary,
  338. Personal Paint searches through all brushes, starting again with brush
  339. number one after reaching the last one.
  340.  
  341.    By painting and defining a two-color brush with the appropriate size,
  342. it is possible to manually create a transparency plane to be used for
  343. another brush with higher precision than can be achieved with the normal
  344. background and fill transparency modes.
  345.  
  346.  
  347. 5.8.8      Copy Image Palette
  348.  
  349.    When a brush is loaded or imported from an environment having different
  350. colors from the current one, it conserves its original color palette even
  351. if it has to be displayed in the current environment colors. This command
  352. resets the brush's internal palette and makes it the same as the current
  353. environment palette.
  354.  
  355.  
  356. 5.9        Clipboard
  357.  
  358.    The Amiga operating system provides for a standard way of exchanging
  359. data (mainly text and graphics) between one application and another,
  360. called the Clipboard. The content of the Clipboard is public, i.e. the
  361. data in it can be read and written by any program.
  362.  
  363.    Thanks to the Amiga Clipboard, for example, the user can drag a
  364. Workbench icon on IconEdit, pass it to Personal Paint, edit it and go back
  365. and use IconEdit again to save the the new image as an icon.
  366.  
  367.    If Personal Paint cannot open the Amiga Clipboard device
  368. ("clipboard.device" file in the system "devs" drawer), the functions which
  369. depend on it will not work.
  370.  
  371.    Some incorrectly written programs may lock the Clipboard under certain
  372. circumstances. This may happen, for example, with text editors that expect
  373. the Clipboard to contain only text, or software that does not read the
  374. Clipboard up to its end, and therefore does not release the resource for
  375. use by other programs. The Empty Clipboard function can be used to prevent
  376. similar problems where they are known.
  377.  
  378.  
  379. 5.9.1      Read Brush
  380.  
  381.    This command searches the Clipboard for graphical data. If a picture is
  382. found, it is copied to the current brush. The original data is not removed
  383. from the Clipboard.
  384.  
  385.  
  386. 5.9.2      Write Brush
  387.  
  388.    This function places a copy of the current brush to the Clipboard,
  389. where it can be used by other programs (as well as by Personal Paint). Any
  390. data previously contained in the Clipboard will be replaced by the new
  391. picture.
  392.  
  393.  
  394. 5.9.3      Empty
  395.  
  396.    This command clears the entire contents of the Amiga Clipboard,
  397. regardless of its type (graphics, text, etc.) This is useful in low memory
  398. conditions, especially if a very large brush which does not need to be
  399. used any more is still stored in the Clipboard.
  400.  
  401.  
  402. 5.10       Resize
  403.  
  404.   The functions described in the following subsections modify the size of
  405. the current brush, which can be either a program default brush, or a
  406. custom (user defined) brush. The brush is stretched to the new size.
  407.  
  408.   Section 8.15 explains how the Color Average Resize option affects brush
  409. resizing.
  410.  
  411.  
  412. 5.10.1     Stretch
  413.  
  414.    This function stretches the brush to any size indicated with the mouse.
  415. When this function is selected, the mouse pointer changes to the stretch
  416. symbol to indicate that the brush stretch mode is active.
  417.  
  418.    When the left mouse button is held down, the upper left corner of the
  419. brush remains "anchored", while the lower right corner reflects mouse
  420. movements, changing the size and shape of the brush. The new size can be
  421. specified by clicking the left mouse button, moving the mouse and
  422. releasing the button.
  423.  
  424.    If <Shift> is held down, the brush can only be resized in accordance
  425. with its original aspect ratio. This means that the image can be resized
  426. smoothly, but not distorted (i.e. made taller or wider).
  427.  
  428.  
  429. 5.10.2     Smaller
  430.  
  431.    This command makes the brush smaller by the smallest possible step,
  432. maintaining the correct display ratio (i.e. X/Y proportions).
  433.  
  434.  
  435. 5.10.3     Bigger
  436.  
  437.    As with Smaller, this function makes the brush slightly bigger.
  438.  
  439.  
  440. 5.10.4     Halve
  441.  
  442.    This function halves the brush. The width and the height are halved,
  443. therefore the total brush surface is reduced to a quarter of the original
  444. brush.
  445.  
  446.  
  447. 5.10.5     Halve Horizontal
  448.  
  449.    This function is a subset of Halve. Only the width is halved, while the
  450. height is left unchanged.
  451.  
  452.  
  453. 5.10.6     Halve Vertical
  454.  
  455.    This function "flattens" the brush. The width is not varied, but the
  456. brush height is halved.
  457.  
  458.  
  459. 5.10.7     Double
  460.  
  461.    This function doubles both the horizontal and vertical brush
  462. dimensions. The resulting brush will have four times as many dots as the
  463. original brush.
  464.  
  465.  
  466. 5.10.8     Double Horizontal
  467.  
  468.    This function is a subset of Double. The brush is doubled only
  469. horizontally. While the width is doubled, the height remains the same.
  470.  
  471.  
  472. 5.10.9     Double Vertical
  473.  
  474.    This function is a subset of Double. The brush is doubled only
  475. vertically. While the height is doubled, the width remains the same as
  476. that of the original brush.
  477.  
  478.  
  479. 5.11       Rotate
  480.  
  481.    These functions perform various rotation operations on the brush.
  482.  
  483.  
  484. 5.11.1     Any Angle
  485.  
  486.    This command locks the lower left corner of the brush as soon as the
  487. left mouse button is pressed, and allows the entire brush to be rotated by
  488. moving the mouse pointer around. For speed reasons, an outline of the
  489. brush may be displayed while the rotation angle is defined.
  490.  
  491.  
  492. 5.11.2     90 Degrees
  493.  
  494.    This function rotates the brush clockwise by 90 degrees. The horizontal
  495. and vertical dimensions of the brush are reversed. If the brush is square
  496. (i.e. if it is as wide as it is tall, in dots) the dimensions do not
  497. change.
  498.  
  499.    The brush handle is repositioned in accordance with the rotation. If
  500. the function is executed four (or a multiple of four) times on the same
  501. brush, the resulting brush will be identical to the original brush.
  502.  
  503.  
  504. 5.11.3     Horizontal Flip
  505.  
  506.    The same flip functions already described in section 4.7, which modify
  507. the content of the entire image, also exist for brushes.
  508.  
  509.    This function transforms the image contained in the brush into its
  510. "mirror" image. The columns of dots, from the left to the right, which
  511. originally made up the brush image, are re-arranged in reversed order
  512. (from the right to the left).
  513.  
  514.  
  515. 5.11.4     Vertical Flip
  516.  
  517.    This function, like Horizontal Flip, modifies the brush image. The
  518. brush is turned upside-down each time the function is selected.
  519.  
  520.    The effect of this function can be undone by repeating the function an
  521. even number of times on the same brush. This is also true for Horizontal
  522. Flip.
  523.  
  524.  
  525. 5.11.5     Shear
  526.  
  527.    This command is similar to a combination of Stretch and Rotate. It can
  528. be used to freely apply different levels of distortion to the brush. As in
  529. these former modes, the lower right corner of the brush can be freely
  530. moved while the left mouse button is held down. If the mouse is moved
  531. horizontally, the top of the brush remains still, while its left part
  532. remains anchored if the mouse is moved vertically. Combined mouse moves
  533. produce intermediate results. It's a bit like pulling a thin sheet made of
  534. rubber. Like many other image processing tools, this one is easier to see
  535. and use than it is to explain.
  536.  
  537.    Holding <Shift> down restricts the mouse to moving along the axis in
  538. which it is moved first.
  539.  
  540.  
  541. 5.12       Chop
  542.  
  543.    The items in this menu are used to examine and optimize the amount of
  544. memory used to store a brush.
  545.  
  546.  
  547. 5.12.1     Info
  548.  
  549.    This requester displays information about the size and quantity of
  550. bitplanes actually used for the current brush, and the minimum size and
  551. number of bitplanes which could store the same brush without any loss of
  552. data.
  553.  
  554.    This information is useful for checking whether some bitplanes are not
  555. even needed (for example, a brush may use only some of the very first
  556. image colors) and whether there are external transparent zones which could
  557. be removed. If more bitplanes than necessary are used, or if border parts
  558. of those bitplanes are used to store transparent data, memory can be saved
  559. with the other functions in this menu.
  560.  
  561.  
  562. 5.12.2     Edges
  563.  
  564.    This command cuts ("chops") all strips on the borders of the brush
  565. which contain only transparent pixels.
  566.  
  567.  
  568. 5.12.3     Planes
  569.  
  570.    This function removes the last unused bitplanes of the current brush.
  571. For example, if the second half of colors in the brush palette is never
  572. used, the last bitplane is removed.
  573.  
  574.    The resulting brush palette will lose the information relative to the
  575. unused colors.
  576.  
  577.  
  578. 5.12.4     Hidden
  579.  
  580.    This command removes all parts of the brush which are not visible (e.g.
  581. hidden by the title bar, tool bar or beyond the limits of the screen or
  582. those of the magnification window).
  583.  
  584.    For example, to print only the central part of a 256-color brush which
  585. is larger than the screen, the brush handle would be placed at the center
  586. of the brush (section 5.14.4). Then, the brush would be moved towards a
  587. corner of the screen and this command would be executed by typing its
  588. keyboard shortcut. The remaining part of the brush could then be moved to
  589. the opposite part of the screen, where the other edges could be cut.
  590. Finally, the desired central rectangle could be printed.
  591.  
  592.    Due to the visual interaction required to move the mouse and select the
  593. parts to be cut, this command should only be executed through its
  594. associated keyboard shortcut. Moving the mouse pointer to select the menu
  595. might cause unpredictable results.
  596.  
  597.  
  598. 5.13       Outline
  599.  
  600.    These functions create different outline effects around non-transparent
  601. parts of brush, using the current foreground color. For three-dimensional
  602. effects, the light source is assumed to be on the top left of the brush,
  603. with shadows cast to the lower right.
  604.  
  605.  
  606. 5.13.1     Simple
  607.  
  608.    This command draws a simple border around the brush, using the
  609. foreground color. No outline is added around corners.
  610.  
  611.  
  612. 5.13.2     Square
  613.  
  614.    This effect is similar to the Simple one, but produces sharper edges.
  615.  
  616.  
  617. 5.13.3     Shadowed
  618.  
  619.    This function is similar to Simple, but applies a border twice as thick
  620. as normal to the bottom and right edges of the brush.
  621.  
  622.  
  623. 5.13.4     3-D
  624.  
  625.    This effect adds a border in the current background color around the
  626. top and left of the brush, and uses the foreground color for the outline
  627. around the bottom and right edges. If a combination of light and dark
  628. colors is selected, the resulting brush will look like a raised object.
  629. Conversely, if the background color is dark and the foreground color is
  630. light, the brush will appear recessed.
  631.  
  632.  
  633. 5.13.5     Trim
  634.  
  635.    This command removes the outermost circle of pixels around the brush
  636. (i.e. an outline 1 pixel thick). Technically, this is accomplished by
  637. temporarily inverting the transparency plane and using it to delete the
  638. pixels.
  639.  
  640.  
  641. 5.14       Handle
  642.  
  643.    The handle of the brush is the position which is linked to the mouse
  644. pointer. It can be positioned anywhere (and may even be outside the
  645. brush). This is especially useful when working with large brushes.
  646.  
  647.    The position of the brush handle is stored and loaded with the brush
  648. data when using the IFF-ILBM file format.
  649.  
  650.    Some functions may automatically reposition the handle (e.g. brush
  651. rotation, resizing, etc.)
  652.  
  653.  
  654. 5.14.1     Custom
  655.  
  656.    This option allows the user to freely define the brush handle position
  657. by clicking on the left mouse button, moving the mouse over the brush
  658. (which is temporarily anchored to the screen) and releasing the button
  659. when the pointer is over the desired position.
  660.  
  661.    This command, combined with Flood Transparency (section 5.8.6), can be
  662. used to select the parts to be made transparent by "flood filling".
  663.  
  664.  
  665. 5.14.2     Upper Left
  666.  
  667.    This option places the brush handle on the top left corner of the
  668. brush.
  669.  
  670.    This brush position is the only one which is guaranteed not to be moved
  671. by a brush resizing operation.
  672.  
  673.  
  674. 5.14.3     Upper Right
  675.  
  676.    This option links the brush handle with the top right corner of the
  677. rectangle which contains the brush.
  678.  
  679.  
  680. 5.14.4     Center
  681.  
  682.    The brush handle position is placed at the center of the brush. If the
  683. center falls between two dots, the lowest of two dots on the same column,
  684. or the rightmost of two horizontally adjacent dots is selected.
  685.  
  686.    This is the default initial brush handle position of Personal Paint.
  687.  
  688.  
  689. 5.14.5     Lower Left
  690.  
  691.    This option places the handle at the lower left corner of the brush.
  692.  
  693.  
  694. 5.14.6     Lower Right
  695.  
  696.    This option links the brush handle with the lower right corner of the
  697. brush rectangle.
  698.  
  699. @ENDNODE
  700.